home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmQTmenuSavvy.z / XmQTmenuSavvy
Text File  |  1998-10-30  |  12KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmQQQQTTTTmmmmeeeennnnuuuuSSSSaaaavvvvvvvvyyyy((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmQQQQTTTTmmmmeeeennnnuuuuSSSSaaaavvvvvvvvyyyy((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           _X_m_Q_T_m_e_n_u_S_a_v_v_y - A widget holding this trait can become a
  10.           menu child
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/MenuT.h>
  14.  
  15.           typedef struct {
  16.                     int                      version;
  17.                     XmMenuSavvyDisableProc        disableCallback;
  18.                     XmMenuSavvyGetAcceleratorProc      getAccelerator;
  19.                     XmMenuSavvyGetMnemonicProc         getMnemonic;
  20.                     XmMenuSavvyGetActivateCBNameProc        getActivateCBName;
  21.           } XmMenuSavvyTraitRec, *XmMenuSavvyTrait;
  22.           vvvvooooiiiidddd ((((****XXXXmmmmMMMMeeeennnnuuuuSSSSaaaavvvvvvvvyyyyDDDDiiiissssaaaabbbblllleeeePPPPrrrroooocccc))))(
  23.           WWWWiiiiddddggggeeeetttt,
  24.           XXXXttttAAAAccccttttiiiivvvvaaaatttteeeeSSSSttttaaaatttteeee,
  25.           cccchhhhaaaarrrr ****((((****XXXXmmmmMMMMeeeennnnuuuuSSSSaaaavvvvvvvvyyyyGGGGeeeettttAAAAcccccccceeeelllleeeerrrraaaattttoooorrrrPPPPrrrroooocccc))))(
  26.           WWWWiiiiddddggggeeeetttt,
  27.           KKKKeeeeyyyyssssyyyymmmm ((((****XXXXmmmmMMMMeeeennnnuuuuSSSSaaaavvvvvvvvyyyyGGGGeeeettttMMMMnnnneeeemmmmoooonnnniiiiccccPPPPrrrroooocccc))))(
  28.           WWWWiiiiddddggggeeeetttt);
  29.           cccchhhhaaaarrrr ****((((****XXXXmmmmMMMMeeeennnnuuuuSSSSaaaavvvvvvvvyyyyGGGGeeeettttAAAAccccttttiiiivvvvaaaatttteeeeCCCCBBBBNNNNaaaammmmeeeePPPPrrrroooocccc))))(vvvvooooiiiidddd)
  30.  
  31.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  32.           This page documents Motif 2.1.
  33.  
  34.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  35.           Menu parent widgets (like XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn) examine their
  36.           children for the _X_m_Q_T_m_e_n_u_S_a_v_v_y trait.  Only those child
  37.           widgets holding the _X_m_Q_T_m_e_n_u_S_a_v_v_y trait can become menu
  38.           children.
  39.  
  40.           The following standard Motif primitive widgets hold this
  41.           trait:
  42.  
  43.              +o  XXXXmmmmLLLLaaaabbbbeeeellll
  44.  
  45.              +o  XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt
  46.  
  47.              +o  XXXXmmmmPPPPuuuusssshhhhBBBBuuuuttttttttoooonnnn
  48.  
  49.              +o  XXXXmmmmPPPPuuuusssshhhhBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt
  50.  
  51.              +o  XXXXmmmmSSSSeeeeppppaaaarrrraaaattttoooorrrr
  52.  
  53.              +o  XXXXmmmmSSSSeeeeppppaaaarrrraaaattttoooorrrrGGGGaaaaddddggggeeeetttt
  54.  
  55.              +o  XXXXmmmmTTTToooogggggggglllleeeeBBBBuuuuttttttttoooonnnn
  56.  
  57.              +o  XXXXmmmmTTTToooogggggggglllleeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt
  58.  
  59.              +o  XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmQQQQTTTTmmmmeeeennnnuuuuSSSSaaaavvvvvvvvyyyy((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmQQQQTTTTmmmmeeeennnnuuuuSSSSaaaavvvvvvvvyyyy((((3333XXXX))))
  71.  
  72.  
  73.  
  74.              +o  XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt
  75.  
  76.              +o  XXXXmmmmDDDDrrrraaaawwwwnnnnBBBBuuuuttttttttoooonnnn
  77.  
  78.           Among the standard Motif manager widgets, only
  79.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnnexamines its children for this trait.
  80.  
  81.         TTTThhhheeee ddddiiiissssaaaabbbblllleeeeCCCCaaaallllllllbbbbaaaacccckkkk TTTTrrrraaaaiiiitttt MMMMeeeetttthhhhoooodddd
  82.           vvvvooooiiiidddd ddddiiiissssaaaabbbblllleeeeCCCCaaaallllllllbbbbaaaacccckkkk(
  83.           WWWWiiiiddddggggeeeetttt cccchhhhiiiillllddddWWWWiiiiddddggggeeeetttt,
  84.           XXXXttttAAAAccccttttiiiivvvvaaaatttteeeeSSSSttttaaaatttteeee eeeennnnaaaabbbblllleeee____ddddiiiissssaaaabbbblllleeee);
  85.  
  86.           The ddddiiiissssaaaabbbblllleeeeCCCCaaaallllllllbbbbaaaacccckkkk trait method allows the menu parent
  87.           (typically, the XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn widget) to enable or disable the
  88.           activate callback associated with the child.
  89.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnncalls this trait method when its XXXXmmmmNNNNeeeennnnttttrrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
  90.           resource is set to a value other than _N_U_L_L.
  91.  
  92.           _c_h_i_l_d_W_i_d_g_e_t
  93.                     Specifies the child widget that holds this trait.
  94.  
  95.           _e_n_a_b_l_e__d_i_s_a_b_l_e
  96.                     Specifies whether to enable or disable the
  97.                     activate callback method associated with the child
  98.                     widget. There are two possible values for this
  99.                     argument: XXXXmmmmEEEENNNNAAAABBBBLLLLEEEE____CCCCAAAALLLLLLLLBBBBAAAACCCCKKKK or XXXXmmmmDDDDIIIISSSSAAAABBBBLLLLEEEE____CCCCAAAALLLLLLLLBBBBAAAACCCCKKKK.
  100.                     XXXXmmmmEEEENNNNAAAABBBBLLLLEEEE____CCCCAAAALLLLLLLLBBBBAAAACCCCKKKK enables the activate callback
  101.                     associated with _c_h_i_l_d_W_i_d_g_e_t; XXXXmmmmDDDDIIIISSSSAAAABBBBLLLLEEEE____CCCCAAAALLLLLLLLBBBBAAAACCCCKKKK
  102.                     disables it.
  103.  
  104.         TTTThhhheeee ggggeeeettttAAAAcccccccceeeelllleeeerrrraaaattttoooorrrr TTTTrrrraaaaiiiitttt MMMMeeeetttthhhhoooodddd
  105.           cccchhhhaaaarrrr ****ggggeeeettttAAAAcccccccceeeelllleeeerrrraaaattttoooorrrr(
  106.           WWWWiiiiddddggggeeeetttt cccchhhhiiiillllddddWWWWiiiiddddggggeeeetttt);
  107.  
  108.           The ggggeeeettttAAAAcccccccceeeelllleeeerrrraaaattttoooorrrr trait method returns the accelerator
  109.           associated with _c_h_i_l_d_W_i_d_g_e_t.
  110.  
  111.           _c_h_i_l_d_W_i_d_g_e_t
  112.                     Specifies a menu child widget.
  113.  
  114.           This trait method returns the accelerator associated with
  115.           _c_h_i_l_d_W_i_d_g_e_t. If there is no accelerator associated with
  116.           _c_h_i_l_d_W_i_d_g_e_t, ggggeeeettttAAAAcccccccceeeelllleeeerrrraaaattttoooorrrr returns _N_U_L_L.
  117.  
  118.         TTTThhhheeee ggggeeeettttMMMMnnnneeeemmmmoooonnnniiiicccc TTTTrrrraaaaiiiitttt MMMMeeeetttthhhhoooodddd
  119.           KKKKeeeeyyyyssssyyyymmmm ggggeeeettttMMMMnnnneeeemmmmoooonnnniiiicccc(
  120.           WWWWiiiiddddggggeeeetttt cccchhhhiiiillllddddWWWWiiiiddddggggeeeetttt);
  121.  
  122.           The ggggeeeettttMMMMnnnneeeemmmmoooonnnniiiicccc trait method returns the mnemonic associated
  123.           with _c_h_i_l_d_W_i_d_g_e_t.
  124.  
  125.           _c_h_i_l_d_W_i_d_g_e_t
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmQQQQTTTTmmmmeeeennnnuuuuSSSSaaaavvvvvvvvyyyy((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmQQQQTTTTmmmmeeeennnnuuuuSSSSaaaavvvvvvvvyyyy((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                     Specifies a menu child widget.
  141.  
  142.           This trait method returns the mnemonic associated with
  143.           _c_h_i_l_d_W_i_d_g_e_t. If there is no mnemonic associated with
  144.           _c_h_i_l_d_W_i_d_g_e_t, ggggeeeettttMMMMnnnneeeemmmmoooonnnniiiicccc returns _N_U_L_L.
  145.  
  146.         TTTThhhheeee ggggeeeettttAAAAccccttttiiiivvvvaaaatttteeeeCCCCBBBBNNNNaaaammmmeeee TTTTrrrraaaaiiiitttt MMMMeeeetttthhhhoooodddd
  147.           cccchhhhaaaarrrr ****ggggeeeettttAAAAccccttttiiiivvvvaaaatttteeeeCCCCBBBBNNNNaaaammmmeeee(vvvvooooiiiidddd)
  148.  
  149.           The ggggeeeettttAAAAccccttttiiiivvvvaaaatttteeeeCCCCBBBBNNNNaaaammmmeeee trait method returns a pointer to a
  150.           static string.  This string names the resource that contains
  151.           the activation callback list for this widget.  For example,
  152.           this trait method will return aaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk for
  153.           XXXXmmmmPPPPuuuusssshhhhBBBBuuuuttttttttoooonnnn and vvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk for XXXXmmmmTTTToooogggggggglllleeeeBBBBuuuuttttttttoooonnnn.
  154.  
  155.      RRRREEEELLLLAAAATTTTEEEEDDDD
  156.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn(3), XXXXmmmmLLLLaaaabbbbeeeellll(3), XXXXmmmmPPPPuuuusssshhhhBBBBuuuuttttttttoooonnnn(3),
  157.           XXXXmmmmDDDDrrrraaaawwwwnnnnBBBBuuuuttttttttoooonnnn(3), XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn(3), XXXXmmmmTTTToooogggggggglllleeeeBBBBuuuuttttttttoooonnnn(3),
  158.           XXXXmmmmPPPPuuuusssshhhhBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt(3), XXXXmmmmTTTToooogggggggglllleeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt(3),
  159.           XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt(3), and EEEExxxxmmmmMMMMeeeennnnuuuuBBBBuuuuttttttttoooonnnn(3).
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                         (printed 10/24/98)
  196.  
  197.  
  198.  
  199.